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OVERVIEW 


Do you ever wish that you aiuld generate some exciting graphics 
with your ATARI Home Computer» but you're discouraged because 
it takes too much time to do the FANCY stuff? With 
CARTOONIST you can easily create moving displays of people» 
objects» or monsters from outer space< CARTOONIST lets you 
create a ''movie"t made up of frames that you design* You can 
play back the frames at speeds up to 200 per second* You can 
save the frames to a diskette to impress your family and friends 
later» 

CARTOONIST gives you full control of your movie 
characteristics* The frames can be short or tall* fat or thin» 
different colors and different shades» CARTOONIST also 
provides you with time-*saving functions to create displays 
quickly» CARTOONIST is for people who like to sit back and just 
have fun with the computer or polish up their programs with 
minimum effort» 

The main idea of animation is to create a moving figure» First 
you create a figure and put it in the first frame of the movie» 
Then change him a bit» perhaps by shifting one leg just a little» 
Store this in the foUowing frame» Then» move the leg just a little 
bit farther and store it in the next frame» and so on» After a 
while you've created a complete sequence for leg movement» 

To animate this figure all you have to do is play the frames» one 
after another» at a high enough speed» and the figure seems to 
walk» The object of the program is to create such figures with as 
little effort as possible» Practically all the functions let you 
make these small changes easily» This way you can spend your 
time doing animation instead of tedious work» 



REOUIRED ACCESSORIES 


ATARI BASIC Language Cartridge 
One ATARI Joysticti Controller 
ATARI 810 or ATARI 1050 Disk Drive 
32ERAM 

OPTIONAL ACCESSORIES 

One set of ATARI Paddle Controllers 








Ge-t'tring s'têLir-ted 

LOADING CARTOONIST INTO COMPUTER MEMORY 

1« Insert the ATARI BASIC Language Cartridge ìnto the cartridge 
slot of your computer. 

2. Plug your JoysticR Controller into the first controller jack of 
your computer console. 

3. Turn your computer OFF. 

4« Turn on your disk drive. 

5« Nhen the BUSY light goes out» open the disk drive door and 
insert the CARTOONIST diskette with the label in the lower 
right hand corner nearest to you. Close the door. (Use disk drive 
one if you have more than one drẃe.) 

6. Turn on your computer and your TV set. The program will load 
into computer memory and start automatically. 

7. After the program has completely loaded into memory you may 
leave the CARTOONIST diskette in the disk drive if you only 
want to use the movies provided with CARTOONIST. 

8. If you wish to create and save your own movies» insert a 
formatted disk into the disk drive slot. 

9. If you'll be doing a lot of design work« label a blank formatted 
disk for use only with the CARTOONIST program. This way all 
your movies will be on one diskette» and you won't waste your 
time searching for the diskette that has the movie you want. 

10. If this is the first time you're running the program you 
should leave the CARTOONIST diskette in the disk drive to play 
with some of the movies provided with that diskette. 
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THE FIRST DISPLAY SCREEN 


The first display screen looks like thisS 
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The disk drive beeps a couple of times and then«»« 

Â multi limbed space gidger walk5.right across the screenü 

This is an example of what you can accomplish using the 
CARTOONIST» You can keep the GIDGER walking across the 
screen by holding down the START button« 

The drive beeps a few more times and then the following prompt 
appearsS 


PLEASE CHOOSE THE 
FRAME HEIGHT 

PIXELS 

The number “40" flashes on the left side of the screen« For most 
purposes 40 pixels is adeguate so press the joystick button to 
select 40« 

The screen clears and displays a message that the program is 
loading the main part of CARTOONIST» 

Nhen CARTOONIST finishes loading into memory« follow steps 7 
through 9 of the GETTING STARTED section of this manual« The 
screen now has a 16 by 40 frame of pixel5 (described later) on the 
left hand sidei and the current menu in the box in the lcwer right 
hand corner« The number in the upper right hand corner is the 
frame number (also described later>« 
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DEFINITION OF TERMS 


Hxel 

Â pìxel ìs the building blocR in CARTOONIST» A pixel is just like 
one square on a sheet of graph paper» A square can either be 
colored in with a penâl or left blank« CARTOONIST works on this 
same prindple» except that the graph paper is replaced by the 
screenf and instead of coloring it with a pendl you fiU it with a 
spot of light» Nhen a pixel is lighted» it's ON« Nhen it's blank 
it's OFF« 

Line 

A line is a horizontal line of pixels« 

Frame 

A frame is a collection of lines« Note that there are 24 lines of 
pixels on the screen« This doesn't mean that you're limited to 24 
lines in a frame« Rather» you can only see 24 lines at one time« 
Frames can contain between 24 and 80 lines depending on what 
you selected just after the first display screen« Forty lines per 
frame is standard« 

Movie 


A movie is a collection of frames« The number of frames that you 
have in a movie depends on the number of lines that you select 
for a frame« If you choose 24 lines per frame you can have up to 
166 frames per movie« Forty lines per frame gives you 100 
frames« Eigh^ lines gives you 50 frames« Each frame in a mavie 
is assigned a number« Nith 100 frames the frame numbers would 
range from 0 to 99« 

Some movies may only be 10 frames long« In fact« it's possible to 
have several different movies located in separate sections of 
memory at once« For instance» you can have one movie occupying 
frames 0-25« while another occupies frames 30-40« 



Directory 


A directory is a list oF all the movies on the disk* After you 
create a movie you can transFer it to a disRette so that you can 
use it later. ^ach movie on it has a name that you give it< PThen 
you ask For a disk directory you see a list oF all the movies that 
are on the diskette« 


Graph 

The graph is an enlargement oF the Frame. The actual Frame you 
design is located in the upper right hand comer oF the screen« 
The graph is a blown up version oF what appears in a Frame. The 
gráph is an array oF dots that you see on the leFt side oF the 
screen. Each dot represents one pixel in the Frame. Actually» 
there are two kinds oF dots« the little ones you see when you 
First start the program» and the big Fat squares« A little dot 
represents a pixel being blankf or OFF« A Fat square represents 
a pixel being iighted. or ON« 

You've already noticed that there are 24 lines in the graph» yet a 
Frame can have up to 80 lines. This inconsistency is because the 
graph may display one 24 line section oF the Frame at a tirne. Tou 
can easily slide it up and down» however» to show any 24 line 
section. 


Cursor 


The cursor shows where you're drawing. The cursor is like the 
pencil you'd use on the graph paper. You can move it about the 
graph and color in or erase any pixel just as you would on graph 
paper. The cursor looks like a iarge bax surrounding a pixel on 
the graph. You control the cursor with the joystick« To color or 
erase a pixel» push the joystick button. IF the pixel was OFF 
beFore» it Flips on* IF it was ON beFore» it Flips OFF« 


Menu 


A menu in CARTOONIST is a list oF things you may want« To do 
something with CARTOONIST» you pick the appropriate selection 
From the menu» and the program leaps to perForm your every 
wish« 
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'W’indow 


The window is your information screen« The window is the large 
box syrrounding the lower right hand portion of the sareen. 
ÇARTOONIST uses the window to show you such things as menus 
and disk directories» and to give you information about the 
program. 

Function 

A function is something you'd like CARTOONIST to do« All 
functions that CARTOÒNIST can perform are listed in the 
various menus« An example of a functíon would be COLOR (as it's 
listed in the rnenu). This function allows you to change the color 
of the frame. 
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HOW TO DO THINGS 




A) Menu operation 

You choose all CARTOONIST functions from menus* There are too 
many functions to list them all in the window at once> so 
CARTOONIST offers you many menus. Each menu contains a list 
of related functions. For instance. the disk mode menu contains a 
list of all functions that pertain to disk operation. 

Menus may contain not only functions. but also other menus. 
These menus contain specialized functions» and other menus 
containing even more spedalized functions. Eventually a menu is 
so spedalized that it contains only a list of functions and you 
can then select what you'd like to do. The general menus are 
referred to as the OUTER menus. while the more spedalized ones 
are referred to as the INNER menus. 

When a menu is displayed in the window» you see an arrow 
pointing at one of the selections. CARTOONIST is waiting for 
you to make a selection. Control the arrow by moving the joystidc 
up and down. To make a selection» push the joystick button. When 
the button is pushed» one of two things happens* 

1. If the selection is another menu. that menu shows in 
the window and you now see the arrow again. 

2. If the selection is a function» the arrow changes color 
to signify that a function is being performed. Some 
functions may ask you a few questions before proceeding. 
After the function is finished the menu again displays in 
the window and the arrow waits for another selection. 

All menus except the MAIN menu have one selection in common. 
BACK. BACK allows you to retum to the previous OUTER menu. 
The MAIN menu has an END OF PROGRAM. All the menus and 
functions are listed in a directory at the end of this manual. 
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B) Speâal keys 


Option » This key is only actiye in-the CREATE function of the 
DESIGN MODE. 

Select » Press the SELECT key while you're in the CREATE 
function» or while the arrow is shown in the window» to display 
the SELECT menu in the window and the arrow waits for you to 
make a selection» The SELECT key is, active only when in the 
CREATE function or when the arrow is shown in the window» 

Star^r » The START key has three functions* 

1» If you press the START key while the arrow is waiting 
for a selection» you see the next OUTER menu» 

2» If you press the START key while a function is astdng 
you a guestion or waiting for you to do something» the 
function halts and you returned to the menu» 

3» To end some functions» you must press the START key» 
You'll be told which functions these are» 

C) Choosing a frame 

Nhen CARTOONIST needs information about a frame» it asks you 
to "CHOOSE FRAME»" Use the joystick to do this» The frame 
number is in the upper right-hand comer» and moving the joystick 
left or right deoreases or increases the frame number by one» 
Moving it up or down decreases or increases the number by five» 
Press the joystick button to select the current frame number» 

For instance» if youYe asked to choose a frame number and the 
frame number is currently 10» move the joystick LEFT and the 
number subtracts 1» giving 9» RIGHT adds 1 giving 11» UP adds 5 
giving 15» and DONN subtracts 5 giving 5» 

Moving the joystick in one direction makes the frame number 
increase or decrease» 

- 9 - 




D) Choosing first and last frame 


Sometimes CARTOONIST needs to know not only one frame» but a 
series of consecutive frarnes» Therefore» choose a first and last 
frame to let CAHTOONIST know that you mean all frames 
between and induding these two^ Choose the frames in the same 
•manner as you would a single frame« 

A few tricks are available to make the process go faster» 
espedally when you're loading movies from disk« If you choose 
the first and last frame to be the same frame number« 
CARTOONIST assumes that you mean the first frame to be ''O" 
and the last frame to be the last frame of thé movie« 

•« • 

If you choose the last frame to be less than the first frame» 
CARTOONIST assumes that you want just the last frame to be 
the last frame of the movie« In other words» you're spedfying the 
entire length of the movie following the first frame« 

E) Choosing a to and from frame 

CARTOONIST sometimes needs to know just two frames« Choose 
each frame just as you normally would« 

F) Choosing a first and last line« 

Some of CARTOONIST's functions let you do things to partial 
sections of a frame« A section is defined as two lines and the 
space between them« Nhen you select a function that allows 
operation on a section of a frame it tells you to "CHOOSE FIRST 
LINE" and "CHOOSE LAST LINE«“ You see a triangular pointer on 
the left edge of the graph« Move it up or down until it's pointing 
at the line that you want to spedfy» Press the joystick button to 
spedfy that line« Do this twice» once for the first line» and once 
for the last line« If you spedfy both lines to the same line» 
CARTOONIST assumes that you mean the entire frame* 
Therefore» press the joystidc button twice to spedfy the entire 
frame* 
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G) Entering a movie name 

You only need the keyboard for one of CARTOONIST's functions! 
saving a movie on disRette# Details of this .operation are 
discussed under the section titled DISK MODE« 

H) Controlling both sides of a frame 

Although a frame may look solid» it's actually two halves« the 
right and the left side» CAHTOONIST lets you change the color» 
widtht or position of each side» Nhen you're changing these 
parameters» you can speâfy which side you want to work on» 
Nhen the joystick button is not depressed» you control the right 
side» If you press and hold the button» you control the left side» 

For examplet if you want to change the color of the frame you 
first use the menu to choose the color function» CARTOONIST 
then waits for you to change the color of the frame with the 
joystick» If you move the -joystic^ around without pushing the 
button» the color changes on the right side of the frame» If you 
hold the button down» the color changes on the left side» Nhen 
you achieve the color combination you want» press the START key 
to complete the operation» 

I) Use of the paddles 

If you're using paddle controUers» plug them into port #2 of your 
computer» You might label them paddle #1 and paddle #2 with a 
sticker» since each has a unique use» Trace the cord coming out 
of the left side of the paddle plug» Refer to this one as paddle 
#1» The other paddle is paddle #2» 

Paddle #1 is used in the ROLL FILM and the ANIMATE functions 
to control frame speed» Twist it completely clockwise to obtain 
animation speeds of up to 200 frames per second» Twist it 
counter-clockwise to slow animation dowh to about 1 frame a 
second» 

Paddle #2 is used in the ANIMATE function only to control the 
sensitŵity of the joystick» If you tum it completely clockwise» 
your figure zooms around the screen as you move it with the 
joystick» At the other ertreme» if you tum it completely 
caunter-clockwise» your figure moves around the screen very 
slowly» Speeds vary between these two positions* 




J) Choosing a movie from the directory 

Nith most of the functions using the disk driye» you choose a 
movie from the disk for some reasoni When you choose such a 
function» the program begins to display all the movies on the 
diskette» one at a time# in the windowi An arrow points to the 
current moviei If this is the movie you want» press the joystick 
button and the function is performed with that moviei If it isn't 
the movie you want« tap the joystick towards you a bit» and a new 
movie is presented with an arrow pointing at iti This continues 
until you've selected a movie» or all the movies on the diskette 
have been listedi At any point you can press the START key to 
return to the menui (Notei If you pass the movie you want» you 
can't back upi Press the START key to return to the DISK MODEi 

K} How to draw on the graph 

This can only be done in the CREATE function of the DESIGN 
MODEi 



The folloẃing is an e^planation of each function or menu in 
CARTOONIST and its operatìon< 

MAIN MENU SELECTIONS 

Oisk mode 

This menu contaìns all functions that relate to using the disk 
drive< 

Design mode 

This menut the heart of the program# contains most of the 
functions relating to the program< You dû all design work using 
this menu< 

Animate mode 

This menu contains all the functions needed to run your 
completed movie and control the joyatick and» if you have it» your 
paddle< You can control the fraime speed» and move your creation 
around the screen < 

End of program 

* 

This menu has only one choice# to quit the program< It's a menu 
instead of a function so that you have a chance of retuming to 
the main menu in case you accidentally choose this selection< 




DISK MODE 


Load film 

This function lets you bring a moviB from a disRette into memory* 
Use the joystictc (see "choosing a movie from the directory") to 
choose» The program displays these puestions on the screeni 
Choose the first frame 
Choose the last frame 

The movie then loads into memory beginning at the first frame. 
Any frames that fall after the last frame will be cut» (Note. An 
easy way to load the entire movie into memory is to press the 
joysticR twice in response to the two prompts.) 

Save film 

This function allows you to save any movie in memory on a 
diskette! 

Choose first frame 
Choose last frame 
Enter name 

The first frame» the last framei and all those in between will be 
Baved on the diskette. using the name (plus the extensiont 
".FRM") that you typed from the keyboard. Names are considered 
legal if they have these characteristics. 

1. At least one character and up to eight characters long» 

2. Any combination of letters and numberst with the first 
character being a letter. 

Some examples of LEGAL names are. 

MYMOTIE 

FILE1234 

STUFF 

Q 

Some examples of ILLEGAL names are 

WHATISTHEMATTERWITHTHIS - too long 
2SDAY - starts with a number» 

You don't need to worry about typing an illegal name. 
CARTOONIST won't let you. Press the RETURN key when you're 
finished» 
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Disk directory 

This allows you to see what movies are on the diskette» Pull the 
joystick towards you so that they continually appear in the 
window. Press the joystick button or the START key to stop the 
operation» 

Lock film 

This allows you to protect a movie on a diskette so that you can't 
acâdentally erase it. All locked movies show up on the disk 
directory with an 'X' in front of them 

Unlock film 

This is the opposite of loddng a MOVIE. It removes the 
protection of the lock» 

Delete film 

This allows you to erase a movie from diskette. You can't delete 
a movie that you've locked. 


DESIGN MODE 
Environment 

Nithin this menu you can change all environmental parameters of 
a frame such as color» position» width» or pixel height» 

Edit film 

Within this menu are all the functions relating to changing the 
sequence or content of your movie» You may rearrange your movie 
on a frame by frame basis. 
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Create 


This is the center of CARTOONIST. üse this function to draw 
your figures. When you select the create function you may draw 
things on the graph. Move the cursor by pushing the joysticR in 
the appropriate direction. Turn the pixels on or off by pressing 
the joysticR button. You can draw lines in any direction by 
holding down the joysticR button while you push the joysticR. If 
you move the cursor off the left edge. it appears on the same line 
on the right edge. The reverse is also true. 

You can choose the 24-line section of the frame you're viewing 
by pushing the cursor against either the top or bottom edge of 
the graph. Âll pixel changes that you make on the graph appear in 
the frame immediately. 

All function keys are active when you create. You press the 
SELECT key to display the SELECT menu. The OPTION key 
restores the frame to its contents when the create function was 
entered. This is useful when you're experimenting with changes 
to a figure and you don't want to undraw everything that you've 
done. (See "Examples and hints on using CARTOONIST 
effectively"). 


Select 


You see this menu if you press the SELECT key. This is a 
collection of the most frequently used functions in this program. 

Scan film 

This function lets you take a look at what you have in your 
movie. It's also used to select a frame to work on. It works 
exactly like choosing a frame. Press the joystick button or the 
START key to stop (Note that this function appears in most 
menus. This is because it's useful in quite a few different 
applications). 
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ENVIRONMENT MENU 


Width 


This let's you control the width of the pixels on either or both 
halves of the framei Pixels can be normal» double» or quadruple 
widthi Use the button to select which half to change» and move 
the joysticR left or right to change widths» Press the START key 
to stop the function» After .you use this function» the frame 
halves may overlap or appear separated* Use the P^smON 
function to correct this split» 


Height 


If you've selected a frame height that's less than 41 pixels 
(CARTOONIST won't let you continue if you select a frame height 
greater or equal to 41 pixels)» this function lets you make the 
pixels either double or single height» Push the joystick away 
from you to switch to double height. Press the START button to 
stop the function» Note that in double height the pixels seem 
blocky and square» while in single height they're rectangular» 7ou 
can't specify double height or single height for individual halves 
of a frame» 

Position 

This function lets you change the position of each half of the 
frame in relation to the other half» Use the joystick button to 
select which half» Move the joystick left or right to slide the half 
to the desired position» Press the START key to stop» 


Color 


This function allows you to change the color or the shade of 
either half of the frame» Use the joystick button to select which 
half» and move the joystick left or right to control color» Move 
the joysticR. up and down to control shade» Note that the name of 
the color you're using appears in the bottom left hand comer of 
the window» All color names are a six letter abbreviation» Tou 
have 16»384 possible color combinations» Press the START key to 
stop this function» 
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Background 


This function allows you to change the color of the backroundf 
using the joystic^ to cyde through the available colors. 

Scan film 

(See SCAN FILM in DESIGN MODE MENÜ) 

EDIT FILM MENÜ 
Insert 

This function allows you to insert a blank fra/ne anywhere in the 
film« This is useful if you'd like to provide additional animation 
in between frames* 

CHOOSE FRAME 

This frame and all frames following are advanced by one frame 
number. The last frame in the movie is lost. 

Delete 


This function allows you to delete a frame anywhere in the film. 
CHOOSE FRAME 

This frame is lost. AU frames following are moved down one 
frame number to fill the vacancy« The last frame in the movie 
becomes blank. 

Exchange 

This function allows you to exchange any two frames in a movie« 
CHOOSE TROM' FRAME 
CHOOSE 'TO' FRAME 
These two frames swap position* 



This function ^lows you to copy any frame to any other frame» 
It's useful for duplicating a frame quickly« 

CHOOSE TROM' FRAME 
CHOOSE 'TO' FRÁME 

The two frames become identical to the first one specified» 


Clear 


This function allows you to clear out any consecutive group of 
frames* It's different from the delete function in that it doesn't 
move any frames down to fiU the empty framesl it simply wipes' 
them clean* 

CHOOSE FIRST FRAME 
CHOOSE LAST FRAME 

All frames in between and including the first and last frame are 
cleared» 

Scan film 

(See explanation in DESIGN MODE MENU) 

SELECT MENU 

For all the following functions* pressing the trigger button in 
response to both FIRST LINE and LAST LINE will select the 
entire frame» This makes it very easy to CLEAR* FILL* INVERT* 
etc» an entire frame» 

Nert (with copy) 

This function copies the current frame to the following frame and 
makes that the current frame» This function eliminates the task 
of redrawing a figure from scratch every time you move on to the 
nert frame» 

CHOOSE FIRST LINE 
CHOOSE LAST LINE 

These two lines and the section between them are copied to the 
nert frame» Copying the section allows you to do animation a 
little bit at a time» For erample» if you're making a walldng man* 
you first make the walkìng legs (copying only that section to the 
nert frames)* then you do the body and swinging arms*and so on» 



Nert (no copy) 

This function simply adds one to the current frame number 
without making any changes to frames* This is useful when you 
need to go back and do individual touch up work to each frame» 


Fill 

This function allows you to fill any section of a frame with ON 
pirels» 

CHOOSE FIRST LINE 
CHOOSE LAST LINE 

All dots between and including these two lines are filled with 
dots» 

Shift 

This function allows you to shift any section of a frame in any 
direction deft» right» up» down» and diagonal)» This is useful for 
quickly moving figures around the frame without having to 
completely redraw them» 

CHOOSE FIRST LINE . 

CHOOSE LAST UNE 

Push the joystick in the desired direction» The section that you 
choose shifts accordingly» Note that all edges shift onto the 
opposite edge so that no portion of the section is lost» Continue 
moving the joystick until you're satisfied» Press the START key 
to stop» 
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Inverse 


This function allows you to invert any section of a frame» In 
other words# it tums all ON dots OFF# and tums all OFF dots 
ON, 

CHOOSE FIRST LINE 
CHOOSE LAST LINE 

These lines, and the section between them, are inverted. 


Clear 

This function allows you to clear any section of a frame, It saves 
you the task of going around and wiping out individual dots, 
CHOOSE FIRST LINE 
CHOOSE LAST LINE 

These lines, and the section between them, are cleared, 

Merge 

This menu has selections assoâated with mergings (See below), 

Mirror 


This is a function that allows you to mirror any section of a 
frame, This is useful for such things as matdng walldng men face 
the other direction without having to completely redraw them, 
CHOOSE FIRST LINE 
CHOOSE LAST LINE 

Move the joysticR away from you or towards you to mirror in an 
over/under fashion, Move the joysticR left or right to mirror 
left/right, Press START to stop, 

Scan film 

(See explanation in DESIGN MODE MENU) 
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MERGE MENU 


This MENU allows you to speâfy how you'd like to combine two 
frames* To combine two framest complete the following steps« 

1* Select the desired merge type (ANDt OE> XOR} by moving the 
arrow to the appropriate selection and pressing the button« 

2« Select the DO MERGE function« 

When you merge two frames» CARTOONIST goes through each 
frame» pixel by pixel» and compares corresponding pixel 
locations« It then combines them to form a new frame« By 
choosing a merge type you're telling CARTOONIST the conditions 
for merging the two frames« The best way to find out what each 
of these merge types does is to experiment« You wiU probably 
find (OR) the most useful« 

(AND) 

If the first pixel AND the second pixel are both ON» then the 
resulting pixel will be ON« 

(OR) 

If either the first pixel OR the second pixel is ON» then the 
resulting pixel will be ON> 

(XOR) 

This is an abbreviation for "exclusive ar«" If either the first 
pixel OR the second pixel is ON> (but not both)» the resultìng 
pixel will be ON« 

DO MERGE 

This function allows you to merge two frames together to obtain 
a new frame« Be sure you spedfy the type of merge you want 
before you use this function or you may obtain different results 
from what you expect« 

CHOOSE FIRST LINE 
CHOOSE LAST LINE 
CHOOSE FRAME 

The chosen frame merges onto the one you started with (FIRST 
LINE» LAST LINE)« You may press START at any time and stop« 
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ANIMATE MODE 


Animate! 

This is the show off function of the program* You'll agree it 
deserves an exclamation point» 7ou can see any portion of your 
movie at a speed you control* and you can simultáneously move 
your creation all around the screen using the joystick« The film 
keeps cycling until you press the START key to cease» 

Roll film 

This function allows you to see any portion of your movie at a 
speed you control by using paddle #1« Again» the film keeps 
cycling until you stop it by pressing the START key« 

Paddles 

Selects use of paddles* (See "Use of Paddles") 

No paddles 

Selects use of SPEED and SENSITIVITY functions instead of 
paddles* 


Speed 


Controls the speed of animation* Choose a value from 1 (fast) to 
200 (slow) by moving the joystick to increase and decrease the 
value« Select the value you want by pressing the joystick button 
or START key« 

Sen5itivity 

Controls sensitivity setting of the joystick« Choose a value from 
1 (quick response) to 200 (sluggish response)* Again« move the 
joystick to increase or decrease the value and select a value by 
pressing the joystick button or START key« 



END OF PROGRAM MENU 


Quit 

Nhen you choose this function» the screen clears and the 
computer drops into the memo pad function. Press the SYSTEM 
RESET key to restart the program. This wipes out anything 
youVe done> so be sure you save any movies that you want before 
you QUIT« 

Back 


You acddentally selected this menu and want to retum to the 
main menu without doing ahy damage» Consider this your second 
chance» 



Sâ^npl 


1» Start the CART00NI5T program as shown in Getting Started« 

2« Select a height of 40 pixels« CAHTÒONIST will load into memory« 

3« Select DISK MODE from the main menu« 

4« Select LOAD FILM from the disk menu» 

5« Choose any movie from the disk directory« 

6« Nhen asked for first and last frames» simply push the jaystick button 
twice sincB you want to use the whole movie« The film wiU lo^ into 
memory« Note the last frame used by the film when it comes in« 

7« Select BACK so that you will return to the main menu» 

8« Select ANIMATE rnode» 

9« Select ROLL FILM or ANIMATE! since you want to play with the filrn» 

10« ChoosB first and last frames making sure that the last frame was 
the last frame brought in from the diskette» 

11« TouYe all set! Use the paddles and/or joystick to play around to 
your heart's content» Tou may want to slow the frame speed way down to 
see how the animation is accomplished» If you don't have paddles» use 
the START key to stop and adjust the frame speed and/or sensitŵity 
using the SPEED and SENSITIVITY functions* 

12« Press the START key to stop» You may load another movie by 
following the steps starting with step #3« 
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l4 Draw figures a bit at a time» For erample» if you're making a 
walRing man you'd first do the moving legs then go back and do 
the swinging arms and waving body^ In this way you aren't faced 
with complicated motions to worry about at once^ You can 
concentrate on one action at a time^ 

« 

c 

2. Use the NEXT(NITH COPY) function to its fullest ertent* 
Nhen you've finished drawing a frame follow this procedure* 

a) Press the SELECT key4 The select menu appears in the 

window4 

b) Press the joystick button (since the green anrow is already 
pointing at NEXT (WITH COPY)^ 

c) Copy the appropriate sections to the next frame^ 

d) Move the green arrow to BACK and press the joystick 
button^ You return to the design mode menu^ 

e) Press the joystick button (since it's already pointing at 
CREATE)4 

f) Draw the next frame^ 

Although this seems complicated at first» you can do it all in a 
few seconds with practicei _ 

34 If you press the SELECT key while the cursor is on the left 
edge of the graph» a NEXT (WITH COPY) occurs for the entire 
framei Be sure not to do this acddentallyi 

Ai Don't be meticulous when you^e drawing an animation 
sequence4 Draw a dose» but quick« approximation of what you 
want4 Then go back and use the NEXT (NO COPY) function to 
touch up your worRi 



5« Make anìmation scenes 'cydic/ Nhen they're played aver and 
□ver you won't be able to tell what the first and last frame is» 
since the motion will be smooth» This is difficult since you have 
to synchronize all movementSt but it makes animation much more 
enjoyable when youYe using the ANIMATE! and ROLL FILM 
functions* See the movies provided with CARTOONI5T for 
examples of how this is done* 

6« Leam to think ahead so that you know what movements you 
need latert Then you won't have to do extensive reworking of 
your movies« 

7t Using these hints (and some you'U come up with on your own^t 
you can create quiCk and lively movies in short periods of time* 


FUTURE USES 

The things you can accomplish with CARTOONIST are almost 
unlimited* The list below indudes some things you may want to 
try doing* 

a) Overlap the sides of the frame to creature multi-colored 
figures* There may be limits on the FRAME widtht but the extra 
color might be worth it* 

b) Make exotic designs that don't look like anything at all but 
that swirl and change and twist and bend* Make something reaUy 
HTPNOTIZING! 

d Put actioh in your games* ReaUy liven them up* 

d) Put animation to sound* Make a dandng snáke or a waltzing 
bear* 

e) Make a game for little kids so they can control a figure and 
run it around the screen* 


f) ABOTE ALL*** USE YOUR IMAGINATIONü 



7ou can use CÂRT00KI5T movies in your own programs and 
games. It is very easy to read CARTOONIST files. All 
CARTOONIST files have an .FRM suffûc. 

FILE FORMAT 

## Input #1JNUMFRAMES number of FRAMES in the füe 
## Input #1IHEIGHT number of PIXELS per FRAME. 

STRING Input #1|BÜFFER$ 

STRING 

« 

« 

« 

« 


Each string is twice as many bytes long as the frame is- high and 
represents one frame. 

For erample. if the frame height was 40 pixelsj each string would 
be 80 bytes long. The first 40 bytes would be for the left half of 
the frarne. and the second 40 would be for the right half. 

Here's a short BASIC program to read in such a file! 

10 DIM FRAME$(100000),BUFFER$(160) 

20 OPEN #1,4,0,"MEEP.FRM" 

30 INPUT #1|NUMFRAMES 
40 INPUT #1|HEIQHT 
50 FOR X=1 TO NUMFRAMES 
60 INPUT #1}BUFFER$ 

70 

FRAME$((X, 1 )*HEIGHT*2+1 ,(X, 1 )*HEIGHT#2+HEIGHT*2)=BUFFE 
R$ 

80 NEXT X 
90 CLOSE #1 
100 ... 

The first 40 bytes of FRAME$ would be the left side of FRAME 
#0. The second 40 bytes would be the right half of FRAME #0. 
The next 40 bytes would be the left half of FRAME #1, and so on. 



HOW THE ANIMATION IS DONE 


Of course it's done with player/missile graphics» If you're not 
familiar with player/missile graphics» there's plenty of good 
reading around* Each FRAME in CARTOONIST is simply tŵo 
players side by sidei That's why the FRAMES are read in from 
the disRette in sections of two* 

To create animation» all you have to do is put both sides of the 
frame in the player/missile area« That is best done usìng 
machine language» but it's possible to get speeds of up to 8 
frames per second using BASIC« Nhat's needed is a short copy 
routine (in machine languaige) that copies any section'of memory 
to any other section of memary« You then create a loop in BASIC 
that calls this routine twice» once fòr each half of the frame» and 
copies the appropriate frames into the player/missile area« The 
animation at the start of CARTOONIST is done in this fashian« 

Animation is quite easy to accomplish« All of the routines used in 
CARTOONIST go through the following steps* 

1« Get a frame stored in memory somewhere and put it in the 
computer's P/M area« 

2« Take care of other duties such as moving the image» reading 
joysticRs or paddles» and other such things« 

3« Depending on conditions» wait for a certain amount of time« 

4« Get the nert frame and go to step #1« 

Animation can be done either through BASIC or through machine 
language« Each has its own advantages and disadvantages« Below 
áre a few examples of each« 
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BASIC 


Animation in BASIC is quite slow-about 10 frames per second is 
maximum» Howevert BASIC is very easy to work with» so if you 
don't need the high speed capabiíitiest BASIC is definitely the 
way to go4 A good example of BASIC animation is in the demo 
program^ You wiU need to have a machine language copy routine 
like the one provided to put the frame quickly in place^ The rest 
can be done using the normal BASIC functions^ The routine in the 
demo program is used.as follows! 

U=USR(ADR(COPY$),A,B,C) 

A is the location to move bytes from, 

B is the location to move the bytes from« 

C is the number of bytes to copy. 
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MACHINE LAMGUAGE 


Machìne language is a little more difFicult to work with since it 
makes you worry about more things» but the speed gains are high« 
300 frames per second is an easy thing to do once you get your 
routine wortdng right» The operation of a machine language 
routine is about the same as a BASIC routine except that it's 
just more complex« To see the ROLL FILM routine that is used in 
CARTOOMI5T» load the file» AMSTART from BASIC and list lines 
116 and 117« You can use this machine language routine in your 
programs by copying these two lines» (I'm sorry that I can't 
proYide a sourcè code print-out» but this was hand assembled» 

The ROLL FILM routine is relocatable and needs to be called in 
this manner» 

U=ÜSR(ADR(AMM$)»A»B»C *D»E»F) 

To use this you'll need to organize your movie into two strings» 
one containing all the left halves in sequence» the other 
containing all the right halves in the same manner* 

A- Base address of the first frame» left half 
B- Same for right half 

C- Base address in P/M memory for player (left) 

D- Same for player 1 
E- Mumber of frames to do 
F- Mumber of pixels per frame 

Plug the paddle in port 2 to control speed and push the START 
key to stop» 
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Oemo Fr-og'TÄm 


TherB are two programs» ROÜTINE and DEMO» on the CARTOONIST di 5 k 
which can be used to help you incorporate your cartoons into your own 
programSi They contain the routines needed to retrieye movies from 
disk> initialiie player-missile graphics» and animate your movies« 

On the following two pages is a program for loading your completed 
cartoons into your own programs» You should play around with it and try 
changing values and so forth» to become familiar with how it works* Pay 
special attention to the "REM" statements, as they tell you what's 
happeningf and give helpful comments* 

In particularf note 

Lines 20000-20120 This is the routine to load a movie from disk* 
Change the filename on line 20020 to load your own movie* 

Lines 20500-20590 This routine initialires the player missle 
graphics* The REM statements indicate which values can be 
changed to suit your particular needs* 

Lines 21000-21080 This routine contains instructions on how to 
display your movie* The REM statements indicate which values 
to change to control where the image is displayed on the screen* 

Lines 21500-21590 This routine animates your movie* 

Line 200 (a machine language subroutine) was deleted from the 
printed copy* To view the whole program» start in BASIC and use 
the LOAD command on filename DEMO* Then list to screen* 
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100 RE21 EXAMPLE CARTOOSrST PROGRAM 
110 REM 

120 RE>1 BY BRYAN TALÜûT 
130 REM 

140 REM 5/10/83 

150 REH 

160 REM 

170 RE.M 

180 REM 

190 REM 

200 RB^ SIORT ROUTIHB TO COPY GROUPS OP DYTES—LOAD PROGRAM 
TO VIEW 

210 GRAPHICS 8+16xPOKE 106,PEEK(106)-16xGRAPHICS OtREM 

RESERVE 4K OP MEMORY SO THAT P/M GRAPHICS WILL WORK IN ANY 

MODE 

220 REM 

230 REM 

240 REM 

250 REM 

1000 R£« —--OK START- 

1010 GOSUB 20000;REM READ IN A MOVIE FROM DISK 

1020 GOSUa 10000 :Rì:.“ YO'JR PROGRAM. HERE*S AN EXAMPLE 

1030 GOSUB 20500:REM SET UP GRAPHTCS 

1C40 GOSUB 21000; RE.M WHAT YOU WANT TO IMAGE TO DO 

1050 GOSUD 21500:REM :iOW ANIMATE ITî 

1070 GOS.U3 11000; RLM MORE PROGRAM. . . 

1080 PRINT ;PRINT ■**••• 111S PRESS START**; 

1090 IF PEEi;( 53279) <>6 THBî 1090 

1100 GRAPHICS OiPRINT "NOW, PUSH RESET TO RESET THE MEMORY 
POINTER. “ 

1110 E21D 
1120 RQ1 
1130 REM 
1140 RE« 

10000 ROi -PUT YOUR PROGRAM HERE— 

10010 RLM DUT liERE IS AN LAAMPLE 
100 20 GRAPHICS 7 

10030 SETCOLOR 0,1,141SETCOLOR 2,12,4xSETCOLOR 4.9,2tSETCOLOR 
1,3,a 

10040 COLOR liDEG 

10050 FOR X-0 TO 360 STEP 20 

lOÜbO PLOT 10,10xDRAWTO 10+9^SIN(X), 10*l'9*C0S(X):NEXT X 
10070 SETCOLOR l,6,aiC0L0R 2 

10100 PLOT 159,79;DRAWTO 119.79:DRAWTO 119,59xDRAWTO 
139.49xDRAWTO 159.59;DRAWTO 159,79 
10110 FOR X-0 TO 24 STEP 8 

10120 PLOT 1274X,62xDRAWTO 127+X,68xNEXT X 

10130 FOR X-62 TO 68 STEP 3:PLOT 127,X:DRAWTO 135,XiPLOT 

143,X:ORAWTO 150,XiNEXT X 

10140 PLOT 131,62iDRAWT0 131,68 

10150 PLOT 147.62xDRAWTO 147,68 

10160 SETCOLOR 1,0,0 

10170 POKE 82,Û:POKE 752,1 

10180 7 “)“i:POR X-I TO 30t7 CHR$(34);tNEXT X 
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10190 RETUBN 
10900 RCrURN 

llüOO R124 -MORE PROGRAM---— 

11010 GOSÜB llllOiREM RIIJG Ü00i<BEI-L 

11020 POR X-1 TO 500iNEXT XxRLM WAIT AWHÎLE 

11030 GOSUB 11110iRr.M RIMG IT AGAIN 

11040 FOR X-1 TO 500xNE>:T X:RI21 WAIT AGAIN 

11050 GOSU3 11200tREM ZAP lllHl 

11060 RLTURN iREM END 

llllO POR X-l TO 190 iNEXT X 

11120 FOR X-14 TO 0 STEP -0*2 

11130 SOUND 0,30.10«X 

11140 NEXT X 

11150 FOR X-14 TO 0 STEP -0.2 

lllóO SOUND 0.40.10*X 

11170 NEXT X 

11180 RETURN 

11200 SOUNO 0.200.B.14 

11210 FOR X-1 TO 100xNEXT X 

11220 FOR X-14 TO 0 STEP -0.2 

11230 SOUND 0.200.8.XiPOKE 704,0:P0KE 705,X;FOR Y-1 TO 5tNEXT 
Y:POKE 704.XiPOKE 705.0 
11240 NEXT X 

11250 POKE 53248,OtPOKE 53249.0 
11260 RETURN 

19999 RE2i 

20000 RE2! —-GET MOVIE FROM DISK— 

20010 DIM NAMC$(15)tRSM NAME OF MOVIE 
20020 NAMB$-*DliMORP.FRM“ 

20030 OPEN I1.4.0,I:AMES 
20040 INPUT #1;NUMFRAMES 
20050 INPÜT #1tKE1GHT 

20060 DIM FRA.MEÇ (NUMFRAMSS* (HEIGHT*2)), BÜFFER$ (160) 

20070 FOR X-1 TO NÜMFRAMES 
20080 INPUT #1;DUFFCR$ 

20090 

FRAME$ ( (X-l) •HEIGIfT»2+1. (X-1) *HElGHT*2-»-»EIGnT*2 )»BUFFER$ i REM 

REAO ONE FRANE IN AT A TIMC 

20100 NCXT X 

20110 CLDSE #1 

20120 RETURN 

20130 REM 

20140 ROi 

20500 REM —INITIALIEE GRAPHICS— 

20510 POKE 559.62tRCM SET PLA'ITIELD 

20520 POKE 53256.OiPOKE 53257,OtREM WIDTH OF PIXELS. ALSO 
IDCPCRIMCNT WITH 16 3 

20530 DIST-eiREM DISTANCE BSTWEEN LEFT HALF OF FRAME & RIGHT. 
DCPCRIMCNT* 

20540 POKE 704,14tPOKE 705,14:REM COLOR OP FRAHE. EXPERIMENT. 
20550 FOR X-53240 TO 5325i:POKE X,0:NEXT X:REM DON’T WORRY 
ABOUT THESE 

20560 POKE 54279, PEEK( 106) iREM LOCATION OF PLAYER MISSLE 
AREA. 
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;rí,70 POKE 53277,3tRUM ESABLE P/M 

?ü5ao MEMl-PEERÍ 106)*256+1024-»-32;MEM2“MEMl + 256;REM TIISSE KEEP 
T.-ACK OP WHERE THE P/M MEMORY SPACE IS LOCATED 
?0590 RETUR.S 
?0599 RI31 

21000 RtM —-MOVTE ’ lUSTRUCTiaiS* — 

21010 DOWII-I 2 O 1 REM HOW FAR DOWH THE SCREEN IS THE MOVIE7 
E^PERIMEMT. 

21015 MEMl*MQil + DOWH 1 MEM2-MEH2 +DOWN 

21020 START«50iREM WHERE TO START THE IMAGE ON THE SCREEN. 
E-'rrERIMEl.'T. 

21030 PINISH-155«REM WHERE WTLL THE IMAGE PINISH. EXPERIMENT. 
21040 SPEED-IiRCM HOW PAST WILL IT MOVE. EXPERIMENT. 

21050 PRAMEl-IiREM PIRST PRAME TO BE USED. 

210G0 ?RAME2-riUMFRA?îBS ;REM LAST FRAME TO BE USED 

2107 0 RQt THB PRÜGRAM WILL KEEP CYCLING THORUGH ALL THE 

JTIAMES BETWEEN 1 6 2 

21030 RETURN 

21090 REM 

21100 REM 

21500 RE2i-NOW AHÎÎIATE ITl- 

21510 FRM-FRAMEliRCM WHICH FRAME TO PUT ON SCREEN 
21520 WHERE-STARTiREM WHERE IS 'niE IMAGE ON THE SCREEN? 

21530 POKE 5324a.WHERE:POKE 53249,WHERE+DIST:REM LOCATED 
ÎM.\GE HORIZONTALLY 

21540 U-USR (ADR( COPYS) , ADR(PRAMES) + (FRM-1) ^HETGHT*2, MEMl, 
HEICHT):REM MOVE LEFT HALF TNTO P/M MEMORY 

21550 Ü-USR (ADR(COPYS ), ADR(FRAMBS) + (FRM-1) *HEIGHT*2+HEIGHT, 
MEM2.HEIGHT) :REM MOVE RIGHT HALP 

21560 WllER£aWHERE+SPECD:FRM-PRM+l«IF FRM>FRAMC2 THEN 
FRM-FRAMEl 

21580 IF WHERS<FINISU THEN 21530 
21590 RETURN 
22000 GOTO 22000 
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E3RSOS lyTESSAOES 


Although you must try vBry hard» it's possible to create some 
problems for CARTOONIST. When you do this, CARTOONIST 
sounds a short warning signal and displays the error message in 
the window. Here's a list of error messages, and what they meanS 

DISK IS FTTLL There's no more room on your dislcette for movies. 
Either delete some movies using the DELETE option, or use 
another diskette that has more room. 

a 

DIRECTORY IS FTJLL There's only room on a diskette for up to 
64 moviBS, no matter how long or short they are. Follow the same 
procedure that you would for DISK IS FTJLL . 

ILLEGAL CHARACTER You actádentally pushed CONTROL-3 
while entering the name of the movie to save to the diskette. 

CAN'T FIND FILE The moviB you specified isn't on the diskette 
that's currently in the drive. This message is only possible if 
you switch diskettes béfore CARTOONIST has a chance to load 
the movie. 

DISK WON'T ANSWER Either your disk drive is tumed off» or a 
connection is loose. Check to make sure that all cables are 
plugged in snugly» 

DI5K IS PROTECTED You get this error when you try any of the 
disk mode menu options (except LOAD HOVIE). This diskettB has 
a write protect sticker on the notch. 

FILE LOCKED You tried to delete a movie that is locked. If you 
want to delete it you first must unlock it» 

*»NEW ERROR»» This means you'vB discovered a totally new 
error. Congratulate yourself and then go look up the error 
number on the inside front cover of the Basic Reference Manual 
to see what you did. 
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Lis'ting o-F irhie 3y[eni_is sn 

■Fu n ct i o n s 


MAIN MEMU 

DI5K MODE 

Lo3d filM 
Save filM 
Disk Directory 
Lock filM 
Unlock fil« 


Delete filn 
B3ck 




DESIGN MODE 


ENUIRONHENT 

Width 


Height 

Position 


Color 

B3ckQround 


Scan filM 
B3ck 


Loads 3 Movie 
in froM disk 
S3ve 3 Movie to 
disk 

Lists 3ll MOVies 
on the disk 
Protects 3 Movie 
against deletion 
ReMoves 
protection 
froM MOvie 
Deletes an 
•jnlocked MOvie 
(to M3in Menu) 


Set width of 
fraMe pixels 
Set height of 
frane pixels 
Set position of 
either frsMe 

h3lf 

Set color of 
fraMe piKels 
Move joystick 
left or right 
until desired 
color is found» 
Press button or 
START key to 
select 

Lets you scsn 
the Movie 
(to design Mode 
Menu) 
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EDIT FlLìi 

Insert 

Delete 

Eîíchange 

Copy 

Clesr 

Scan filM 
B3ck 

CREATE 

CSELECTD 

Next(with copy'î 

Next(no copy) 
Fill 

Shift 

Inverse 

Clesr 


Inserts a bl3nk 
frane in Movie 
Deletes 3 fr3Me 
in Movie 
E>:ch3nQes two 
frsMes 

Copies one frsMe 
onto snother 
Cleers çiroup of 
consecutive 
f rsMes 

Lets you sc3n 
the Movie 
(to design Mode 
Menu) 

Desiçin grsph 


Copies current 
frsMe to 
neKt frsMe 
IncreMents frsMe 

Fills 3ny 
section of 3 

fr3Me 

Lets you shift 
3ny section of 
frsMe 

Inverts 3ny 
section of 3 
f rsMe 

Cleers 3ny 
section of a 

f r3Me 
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% 


CSELECT3 CONT. 
Merge 


(AND) 

Sets type of 
Merge ss AND 

(OR) 

Sets type of 
Merge 3S OR 

(XOR) 

Sets type of 

Merge 3S 

eî<cli.isive or 

Do Merge 

Merges two 
frsMes 
together 

Scan filM 

Lets you scsn 
the Movie 

BacR 

(to select Menij) 

.Mirror 

Mirrors 3ny 
section of 3 
f r 3Me 

Scan FìIm 

Lets yoij sc3n 
the Movie 

B3ck 

(to design Mode 
Mernj) 

SCAN FILM 

Lets you scsn 
the Movies 
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ANIMATE MODE 

AniMste! 

Roli filM 
Peddles 

No peddles 
Speed 

Serisitivity 

B3ck 


Plsys Movie* 
control with 

joysticR 
Plsys Movie 
Selects 

use of psddles 
selects no 
psddles 
Selects 
speed of 
sniMation 
Selects 
sensitivity 
of JoysticR 
(to M3in Menu) 


END QF PROGRAM 

Quit 


B3ck 


Absolutely quits 
the prosrsM 
(to M3in Menu) 
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ATARI Program Exchange 

P.O. Box 3705 

Santa Clara, CA 95055 


We’re interested in your experiences with 
»APX programs and documentation, both fa- 
vorabie and unfavorable, Many of our authors 
are eager to improve their programs if they 
know whatyou want. And, of course, we want 
to know about any bugs that slipped by us, so 
that the author can fix them. We also want to 


Review Fonn 

know whether our instructions are meeting 
your needs. You are our best source for 
suggesting improvementsl Please help us by 
taking a moment to fill in this review sheet. 
Fold the sheet in thirds and seal it so that the 
address on the bottom of the back becomes 
the envelope front Thank you for helping us! 


1. Name and APX number of program. 
Cartoonist (237)_ 


2. If you have. probiems using the program, please descríbe them here. 



3. What do you especially like about thís program? 


4. What do you think the program’s weaknesses are? 


5. How can the catalog descríption be more accurate or comprehensive? 


6. On a scaie of 1 to 10,1 being “poor” and 10 being “exceilenr, piease rate the foilow- 
ingaspects of this program: 

Paay tr> i ig» 

_User-oríented (e.g., menus, prompts, clear language) 

_En joyable 

_Seif-instructive 

Use (non-game programs) 

____ lmaginative graphics and sound 


7. Deseribe any technical errois you found in the user instructions (piease 
page numbers). 




8. What did you especially like about the user instructions? 



9. What revisions or additions wouid improve these instructions? 



10. On a scale of 1 to 10,1 representing “poor" and 10 representing “excellenr, how 
would you rate the user instructíons and why? 



11. Other comments about the program or user instructions: 




ATARI Program Exchange 

P.O. Box 3705 

Santa Ciara, CA 95055 



[seal here) 



